Lecture 5 

OpenGL: 
Control functions 
OpenGL program structure 
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GLUT 



• OpenGL Utility Toolkit (GLUT) is a library of functions 
that provides a simple interface between the 
OpenGL application and the underplaying systems 
(window system and operating system). 

• It's a cross-platform library (function naming and 
parameters are the same, but there are different 
implementations for different platforms) 
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Graphics window 



• A graphics application displays it's output on a 
rectangle area on the screen (window) and is 
controlled by the user using inputs from the 
keyboard, mouse, etc. 

• Creating the window, manipulating it, getting inputs 
and related tasks are done through the GLUT 

• A window is a rectangle area on the screen. It 
displays the contents of the Frame buffer. The 
position in the window is specified using window or 
screen coordinated (pixels) 
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Graphics window on a window system 



Other window 
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Coordinates and positions 



Malm Power Sine W*>« 




Engineers and scientists 
put the origin in a 
convenient location: 
Usually the center or the 
lower left corner 
OpenGL consider the 
lower-left corner of the 
window as the origin (x 
increases right and y 
increases up) 




Window system 
origin 



OpenGL origin 




Conversion is 
required 



The origin of the window on a raster 
system is the upper-left corner (y 
increases down and x increases left. 
Mouse input function gives the position 
in raster system coordinates 
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Interaction with the 
window system from a 
graphics application, 

Initialize the window system, We can control the 
initialization using parameters 

glutlnitdnt •argcv, char **argv) 

Create window with a given title. The defaults 
for size, color model,.. Are used 

glutCreateWindowCchar «titl«) 

But we can enforce our setting rather than using 
the defaults 

glutImtDisplayMode(GLUT_RGB I GLlfT.DEPTH I GLVT.DOUBLE) ; 
glutInitVindovSize(640, 480); 
glutlnitWindowPosition(O.O) ; 



Although our screen may have a 
resolution of, say, 1280 x 1024 
pixels, the window that we use 
can have any size. Thus, the 
frame buffer must have a 
resolution equal to the screen 
size. Conceptually, if we use a 
window of 300 x 400 pixels, we 
can think of it as corresponding 
to a 300 x 400 frame buffer, even 
though it uses only a part of the 
real frame buffer. 
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Aspect Ratio and 
Viewports 



The aspect ratio of a rectangle is the ratio 
of the rectangle's width to its height. 

The aspect ratio of the projection plane 
clipping window a (specified by glOrtho, 
for example) is independent of the aspect 
ration of the screen window (b) 

Default: The entire contents of the 
projection plane clipping window is 
mapped to the entire screen window size 
(the view port is the entire window). 
Hence object deformation are possible. 

We can avoid this deformation by making 
the two aspect ration the same either by 
controlling the clipping window size or by 
controlling the display size on the screen 
window (view port) 
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Clipping window 

void glVieiiport (GLint x, GLint y, GLstzei v, GLsizei h) 

x and y are the coordinate of the lower-left corner 
of the Viewport measured relative to the lower-left 
corner of the window, w and h are width and 
height. All is pixels 



copy. It has not been passed any revision 



View port is a part of the GL state 



The viewport is par t of the state. If we change the viewport 
between rendering objects or rendering the same objects with 
the viewport changed, we achieve the effect of multiple 
viewports with different images in different parts of the window. 




There is a single viewport. Changing its 
location and size to different areas in 
the graphics screen window enables us 
to put different graphics on the same 
window 
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The main, Display, and Reshape Functions 



When the OpenGL programs executes. It renders primitives as it reads it. 

• Why the programs waits after it finishes rendering and does not 
terminate immediately? 

• What happens if the graphic widow is resized by the user, covered then 
uncovered by another window ? 

When the OpenGL executes it starts by doing the required initialization, 
Creating the window, specifying some functions for specific purposes and 
finally enter a endless loop waiting for events to occur. 
Functions and purposes 

• Display function : responsible of drawing the graphics 

• Reshape function: Responsible of taking the necessary actions when the 
screen window is resized 
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The main, Display, and Reshape Functions 



♦include <GL/glut.h> 

▼old stain ( in t argc, char **argv) 



glutlnit(ftargc.argv) ; 

glutlnitDisplayMode (GLUT.SINGLE I GLUT. RGB) ; 
glut InitWindovSize (500, 500) ; 
glatInitVindowPo8ition(0,0) ; 
glutCreateWindov(" simple OpenGL example"); 
glutDisplayFunc (display) ; 
nyinitO; 
glutMainLoopO ; 



We need the two functions in the 
same source file or in an included 
file: One called display, the other 
myinit() 

• The display function call back is 
required by OpenGL 

• The myinitQ function is just a 
preference to isolate the 
initialization of the state machine 
, viewing and other user options 
in a separate function 
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Program structure 

This is the general structure that we 
will follow in almost all programs 

• Display function has an arbitrary 
three vertices defined in it, and an 
arbitrary initial point is determined 
within the triangle that they define. 

• Note that we picked the values in 
glOrtho so that the clipping window 
contains the whole triangle and 
there is no relationship between 
the size of the window on the 
display and the size of the clipping 
window; although by making both 
these windows square, there is no 
shape distortion of the gasket. 



1 /• Two-Dimensional Sierpinski Gasket •/ 

2 /* Generated Using Randomly Selected Vertices */ 

3 /• And Bisection •/ 

4 #include "stdafx.h" 

5 iinclude <stdlib.h> 

6 #ifdef APPLE 

7 tinclude <GLUT/glut .h> 
3 #else 

9 #include <GL/glut.h> 

LC #endif 

: : void myinit () 

12 { 



13 /* attributes •/ 

14 glClearColor (1.0, 1.0, 1.0, 1.0); /• white background •/ 

15 glColor3f (1.0, 0.0, 0.0); /* draw in red •/ 

16 /* set up viewing */ 

17 /• 500 x 500 window with origin lower left */ 

18 //glMatrixMode (GL_PROJECTION) ; 

19 //glLoadldentityO ; 

20 gluOrtho2D(0.0, 50.0, 0.0, 50.0); 

21 //glMatrixMode (GL_MODELVIEW) ; 

22 ) 
23 

2h void display ( void ) 

25 < 

26 GLfloat vertices ( 3] [2] -{ { 0 . 0, 0 . 0} , {25 . 0, 50 . 0 } , { 50 . 0, 0 . 0 ) } ; /« A triangle •/ 

27 int j, k; 

28 GLfloat p[2) -{7.5,5.0}; /* An arbitrary initial point inside traingle •/ 

29 glClear (GL_COLOR_BUFFER_BIT) ; /*clear the window •/ 

30 /* compute and plots 5000 new points */ 

31 glBegin(GL POINTS) ; 

32 for( k»0; k<5000; k++) 

33 ( 

34 j-rand()%3; /• pick a vertex at random */ 

35 /* Compute point halfway between selected vertex and old point •/ 

36 p[0] - <p[0]+vertices(j] [0])/2.0; 

37 p(l] - (p[l]+vertices(j) IlJ)/2.0; 

38 /* plot new point */ 

39 glVertex2fv(p) ; 

40 ) 

41 glEndO; 

42 glFlushO; /• clear buffers •/ 

43 ) 

44 int main (int argc, char** argv) 

45 { 

46 /* Standard GLUT initialization */ 

47 glutlnit (&argc,argv) ; 

48 glutlnitDisplayMode (GLUT_S INGLE I GLUT_RGB) ; /* default, not needed */ 

49 glutlnitWindowSize (500, 500) ; /* 500 x 500 pixel window */ 
glutlnitWindowPosition (0, 0) ; /* place window top left on display */ 

51 glutCreateWindow ("Sierpinski Gasket"); /* window title •/ 

52 glutDisplayFunc (display) ; /* display callback invoked when window opened */ 

53 myinit (); /• set attributes •/ 

54 glutMainLoop ( ) ; /* enter event loop */ 

55 ) 
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Report discussion 



Previous lecture repot: 
Problem 2.15 



Next lecture repot: 
Problem 2.9 



In OpenGL, we can associate a color with each vertex. 
If the endpoints of a line segment have different 
colors assigned to them, OpenGL will interpolate 
between the colors as it renders the line segment. It 
will do the same for polygons. Use this property to 
display the Maxwell triangle: an equilateral triangle 
whose vertices are red, green, and blue. 



We saw that a fundamental operation in graphics 
systems is to map a point (x, y) that lies within a 
clipping rectangle to a point (x s , y s ) that lies in the 
viewport of a window on the screen. Assume that the 
two rectangles are defined by OpenGL function calls 
as follows: 

glViewport(u, v , w , h); 

glu0rtho2D(x-min, x-max, y-min, y-max); 

Find the mathematical equations that map (x, y) into 

(* s > Y s )- 
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Polygons and recursion: 
Gasket example 



To structurally design an OpenGL 
program to produce a Gasket, we need 
to divide the task to simple tasks 

First, we need a simple function that 
draw a triangle 



void triangle (GLfloat *a, GLfloat «b, GLfloat *c) 
{ 

glVertex2fv(a) ; 
glVertex2fv(b) ; 
glVertex2fv(c) | 



Gasket 

• Connect the side mid-points in a triangle 
we sub divide it into 4 triangles 

• Remove the middle triangle 

• Repeat the process on each sub-triangle 
of the remaining three 

• Continue until the triangle become very 
small 
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Getting the sub-triangle vertices from the vertices 
of a triangle 

Triangle vertices: Glfloat v[3][2]; 

The three mid-points are: Glfloat m[3][2]; 




for(j=0; j<2; J+O »[0] Cj]-(v[0] [j]«Mr[l] [j])/2.0; 
for(j-0; j<2; J4*J m[l] [j]-(v[0] [j]*v[2] [J])/2.0; 
for(j-0; j<2; j-^) a[2] Cj)-(v[l] Cj]*v[2] [j] )/2.0; 

Then we draw the triangles using the vertices or use them 
for further divisions 

(vCO] p «[0] , m[l])i (v[2] , mta i *[2]); and (v[l] , m[2] , ■[<>]) 
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Polygons and recursion: 
Gasket example 



Polygons and recursion: 
Gasket example 



GLfloat v[3] [2]=U-1>0, -0.581, 11,0, -0.5SL (0.0, 1*1S)J? 
int r_; 



void triangle ( GLfloat *a, GLfloat *b, GLfloat *c) 

/• specify one triangle */ 



( 



glVertex2fv(a) ; 
glVertex2fv(b) ; 
glVertex2fv(c) ; 



glMatrixMode (GL_PR0JECTI0N) ; 
glLoadldentity (7; 
gluOrtho2D(-2.0, 2.0, -2.0, 2.0); 
glMatrixMode (GL_MODELVIEW) ; 
glClearColor (1.0, 1.0, 1.0, 1.0); 
glColor3f (0.0,0.0,0.0) ; 



mt main(int argc, char **argv) 

n-5; /• or set number of subdivision steps here */ 
glutlnit (fcargc, argv) ; 

glutInitDisplayMode(GLUT_SINGLE I GLUT_RGB) ; 
glutlnitWindowSize (500, 500) ; 
glutCreateWindow("Sierpinski Gasket") ; 
glutDisplayFunc (display) ; 
myinit () ; 
glutMainLoopO ; 



void divide_triangle (GLfloat *a, GLfloat *b, GLfloat *c, int ra) 
{ 

/* triangle subdivision using vertex numbers */ 

GLfloat v0[2], vl[2), v2[2]; 
int j; 
if (m>0) 
( 

for(j-0; j<2; j++) vO [ j ] - (a [ j ] +b[ j ] ) 12; 
for(j»0; j<2; j*+) vl t j ] - (a [ j ) +c[ j ] ) 12; 
for(j-0; j<2; v2 [ j ] - (b [ j ] +c[ j ] ) 12; 

divide_triangle (a, vO, vl, m-1); 
divide_triangle (c, vl, v2, m-1); 
divide~triangle (b, v2, vO, m-1); 

) 

else triangle (a, b,c) ; /* draw triangle at end of recursion */ 



void displayO 
{ 

glClear(GL COLOR BUFFER BIT); 

glBegin (GLJTRI ANGLES) ; 

divide triangle (v [0] , v[lj, v[2], n) ; 

glEndO; 

glFlushO ; 
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